home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Leser 15 / Amiga Plus Leser CD 15.iso / Tools / Freeware / PerfectPaint / RayLabFactory / docs / amiga.doc < prev    next >
Encoding:
Text File  |  2002-03-13  |  7.7 KB  |  177 lines
  1.  
  2.  
  3.                             RayLab 1.1 for Amiga
  4.  
  5.  
  6.                       (c)1995-1996 by Marcus Geelnard
  7.  
  8.  
  9. Introduction:
  10. -------------
  11.  
  12. RayLab  was  mostly developed on an Amiga 3000 with gcc 2.7.0 (some testing
  13. and coding was done on a mighty DEC Alpha, with gcc/cc).  Gcc has proven to
  14. produce  smaller  and  faster (in most cases) executables than SAS/C (which
  15. was  used  to compile RayLab 1.0).  Thus the executables that come with the
  16. Amiga distribution of RayLab 1.1 were compiled with gcc 2.7.0.
  17.  
  18.  
  19. Requirements:
  20. -------------
  21.  
  22. RayLab  needs  AmigaOS  2.0  or  better  to work, partly because of the new
  23. display-routines  that  require  kickstart  v36 or higher to work, but also
  24. because  gcc  does  not support AmigaOS 1.x (why should it?).  I think that
  25. this  will  be no limitation to the majority of potential RayLab users (?).
  26. If  you  would need a compilation for older versions of the AmigaOS though,
  27. either  compile  RayLab  on  your  own,  keeping  in  mind that the display
  28. routines will not work, or contact me, and I'll do my best.
  29.  
  30. Other requirements? I have run RayLab on an Amiga 500 with kickstart 37.175
  31. and 512KB Chip + 512KB Slow memory, one disk-drive only (no hd). It worked!
  32. It was even over four times faster than a 386SX-20MHz running Windows!
  33.  
  34. Please  note  that  the stack needs to be set quite high for RayLab to work
  35. properly.   I  use a stack-size of 50000, which seems to work well.  RayLab
  36. refuses  to  run  if  the stack is less than 40000.
  37.  
  38.  
  39. Contents:
  40. ---------
  41.  
  42. The Amiga distribution of RayLab contains the following:
  43.  
  44. · Two executables:   raylab000  - for all Amigas (68000 or better)
  45.                      raylab881  - for Amigas with 68020+ and an FPU
  46.  
  47. · The documentation for RayLab:
  48.      raylab.doc    - a plain ascii version of the documentation
  49.      raylab.guide  - a comprehensive amigaguide-formatted version, with
  50.                      some graphical figures (requires MultiView)
  51.      amiga.doc     - (this file)
  52.  
  53. · Sample RayLab scenes and some texture-images to go along with them.
  54.  
  55. · The sourcode for RayLab,  including  the Amiga specific code,  a makefile
  56.   for gcc and  one for  SAS/C 6.x,  and the  generic code/makefile  for any
  57.   platform.
  58.  
  59.  
  60. Installation:
  61. -------------
  62.  
  63. You may already have installed RayLab, if you are reading this.  Otherwise,
  64. this is what you need to do:  Extract all files from the RayLab lha-archive
  65. to  a  proper place on your harddisk (e.g.  Work:Graphics/RayTracing/).  If
  66. you  have extracted the files to a temporary directory (e.g.  RAM:), simply
  67. drag-and-drop the RayLab drawer icon to where you want it on your harddisk.
  68.  
  69. After  installing  the  files  to  a  proper  place,  you should rename the
  70. executable  that  you  intend  to use (raylab000 or raylab881) to 'raylab'.
  71. Some  special  features of the guide documentation requires this, and it is
  72. much easier to type 'raylab ...' than 'raylab881 ...', for instance.
  73.  
  74. Also,  it  would  be  wise to create some new directories for your own use,
  75. especially one for your own scenes and one for pictures.  For example:
  76.  
  77.          ..../RayLab/MyScenes/
  78.          ..../RayLab/MyPics/
  79.  
  80. This way it will be easier to keep track of your RayLab files.
  81.  
  82. Before  you  use  RayLab,  please finish reading this doc.  Then proceed to
  83. reading  the  full  documentation.  You can either choose to read the plain
  84. ascii  version  (raylab.doc)  or  the  guide (raylab.guide), but I strongly
  85. recommend  the  latter  one.   The  guide is sequential, so you can use the
  86. browse  buttons  to browse forward and backward in the documentation, which
  87. can  be good the first time you read the doc, as you should really read the
  88. whole  documentation  to get to know how RayLab works.  If you want to have
  89. the  users  documentation  printed  on  paper,  you  can get the postscript
  90. version  of  the  documentation, which is available at RayLabs home-page on
  91. the  www  and  on Aminet under gfx/3d (or hopefully from where you got this
  92. archive).
  93.  
  94.  
  95. Amiga specific:
  96. ---------------
  97.  
  98. Currently  you  will have to use RayLab from shell.  RayLab was intended to
  99. be as portable as possible, and I frequently run it on a unix system (which
  100. is  about  10000% faster  than  my  A3000-28MHz) so I have not yet made any
  101. working  GUI.  I have tried to make one, but it will not be ready until the
  102. next release, at the best.
  103.  
  104. The  Amiga version of RayLab can display a picture as it is being rendered.
  105. To  make it do so, use the -d flag on the command line when you are calling
  106. RayLab, or add the following to a globals section in your scene description
  107. (read 'raylab.doc' for more information):
  108.  
  109.         display x
  110.  
  111. ...where  x  is  the  display-mode.   These  are  the  currently  supported
  112. display-modes for the Amiga:
  113.  
  114.   0  - No display  (default)
  115.   1  - Chose display-mode from a requester
  116.   2  - Greyscale, hires, interlaced (dithered)
  117.   3  - HAM6, lowres, non-interlaced (dithered)
  118.   4  - HAM6, lowres, interlaced     (dithered)
  119.   5  - HAM8, lowres, non-interlaced (non-dithered)
  120.   6  - HAM8, lowres, interlaced     (non-dithered)
  121.   7  - HAM8, hires, non-interlaced  (non-dithered)
  122.   8  - HAM8, hires, interlaced      (non-dithered)
  123.  
  124. (RayLab 1.0 users: Note the changes in display numbers!)
  125.  
  126. If you forget the display-numbers (most likely) use the -l flag to list all
  127. available display-modes (the -l flag should work on all platforms, not just
  128. the Amiga).
  129.  
  130. You can either choose one of the 'fixed' display-modes (2-8) which will use
  131. the  standard  monitor, or you can use the display requester (mode 1), from
  132. which    you    can    choose    just    about    any   display-mode   (e.g
  133. NTSC:Superhires-HAM8).  If the mode you choose is not HAM, the display will
  134. be  grey-scale  (2-256 colors are supported for grey-scale).  In the future
  135. RayLab  will  hopefully  support  CyberGraphics  true color screens as well
  136. (which is one reason for the display-requester to be there).
  137.  
  138. Please  note  that  the  HAM6  display  is far from perfect (I can not tell
  139. anything about the HAM8 display, haven't got it :-( ), but the general idea
  140. is that it should only serve as a rought preview anyway.
  141.  
  142. With  the  display  turned  on,  the rendering will be slightly slower, but
  143. probably  not  enough  for  you  to  notice (a 320x240 HAM6 screen takes 20
  144. seconds  on  an  Amiga 3000, as compared to some potential 10-60 minutes of
  145. computing).
  146.  
  147. When  the  rendering is done, you are able to select 'Close' from a menu on
  148. the  screen  (by  pressing  the  right  mouse-button).  This will close the
  149. display  and  exit  RayLab.   The menu will not appear until the picture is
  150. completed.   If you did not open a display (or if RayLab was unable to open
  151. one), RayLab will just exit when it is done rendering.
  152.  
  153. If you want to terminate RayLab during rendering, activate the shell-window
  154. from  which  you started RayLab (it is active by defult), and press CTRL-C.
  155. RayLab  will  then cleanup and exit gracefully.  The output picture will be
  156. correct  and  viewable  after a break if the output format is either iff or
  157. tga  (this  is  a  new feature introduced with RayLab 1.1), but you may not
  158. continue  rendering  the  picture where you stopped rendering (that will be
  159. implemented in the future), so you will have to start it all over again.
  160.  
  161.  
  162. Compiling on your own:
  163. ----------------------
  164.  
  165. If  you would like to compile RayLab for the Amiga on your own, simply copy
  166. the  Amiga  specific code and the makefile(s) that you want to use from the
  167. source/platform/amiga  directory  to  the  source directory.  Makefiles are
  168. available  for both gcc and for SAS/C 6.x.  Please refer to the makefile(s)
  169. for  more  information  about compiling RayLab for different machines.  Now
  170. you are on your own!
  171.  
  172. Please  note that you may not spread a new compilation of RayLab without my
  173. permission!   This  is  to avoid misunderstandings about who is responsible
  174. for  supporting  the  users  of  your  compilation.   Read 'raylab.doc' for
  175. further info about legal issues...
  176.  
  177.